12 const callPackagelist = rpc.declare({
14 method: 'packagelist',
17 const callSystemBoard = rpc.declare({
22 const callUpgradeStart = rpc.declare({
24 method: 'upgrade_start',
29 * Returns the branch of a given version. This helps to offer upgrades
30 * for point releases (aka within the branch).
33 * SNAPSHOT -> SNAPSHOT
34 * 21.02-SNAPSHOT -> 21.02
35 * 21.02.0-rc1 -> 21.02
38 * @param {string} version
39 * Input version from which to determine the branch
41 * The determined branch
43 function get_branch(version) {
44 return version.replace('-SNAPSHOT', '').split('.').slice(0, 2).join('.');
48 * The OpenWrt revision string contains both a hash as well as the number
49 * commits since the OpenWrt/LEDE reboot. It helps to determine if a
50 * snapshot is newer than another.
52 * @param {string} revision
53 * Revision string of a OpenWrt device
55 * The number of commits since OpenWrt/LEDE reboot
57 function get_revision_count(revision) {
58 return parseInt(revision.substring(1).split('-')[0]);
63 init: [ 0, _('Received build request')],
64 container_setup: [ 10, _('Setting up ImageBuilder')],
65 validate_revision: [ 20, _('Validating revision')],
66 validate_manifest: [ 30, _('Validating package selection')],
67 calculate_packages_hash: [ 40, _('Calculating package hash')],
68 building_image: [ 50, _('Generating firmware image')],
69 signing_images: [ 95, _('Signing images')],
70 done: [100, _('Completed generating firmware image')],
71 failed: [100, _('Failed to generate firmware image')],
73 /* Obsolete status values, retained for backward compatibility. */
74 download_imagebuilder: [ 20, _('Downloading ImageBuilder archive')],
75 unpack_imagebuilder: [ 40, _('Setting Up ImageBuilder')],
78 request_hash: new Map(),
81 applyPackageChanges: async function(package_info) {
82 let { url, target, version, packages } = package_info;
84 const overview_url = `${url}/api/v1/overview`;
85 const revision_url = `${url}/api/v1/revision/${version}/${target}`;
87 let changes, target_revision;
90 request.get(overview_url)
91 .then(response => response.json())
92 .then(json => json.branches)
93 .then(branches => branches[get_branch(version)])
94 .then(branch => { changes = branch.package_changes; })
96 throw Error(`Get overview failed:<br>${overview_url}<br>${error}`);
99 request.get(revision_url)
100 .then(response => response.json())
101 .then(json => json.revision)
102 .then(revision => { target_revision = get_revision_count(revision); })
104 throw Error(`Get revision failed:<br>${revision_url}<br>${error}`);
108 for (const change of changes) {
109 let idx = packages.indexOf(change.source);
110 if (idx >= 0 && change.revision <= target_revision) {
112 packages[idx] = change.target;
114 packages.splice(idx, 1);
120 selectImage: function (images, data, firmware) {
121 var filesystemFilter = function(e) {
122 return (e.filesystem == firmware.filesystem);
124 var typeFilter = function(e) {
125 let efi_targets = ['armsr', 'loongarch', 'x86'];
126 let efi_capable = efi_targets.some((tgt) => firmware.target.startsWith(tgt));
129 return (e.type == 'combined-efi');
131 return (e.type == 'combined');
134 return (e.type == 'sysupgrade' || e.type == 'combined');
137 return images.filter(filesystemFilter).filter(typeFilter)[0];
140 handle200: function (response, content, data, firmware) {
141 response = response.json();
142 let image = this.selectImage(response.images, data, firmware);
144 if (image.name != undefined) {
145 this.sha256_unsigned = image.sha256_unsigned;
146 let sysupgrade_url = `${data.url}/store/${response.bin_dir}/${image.name}`;
148 let keep = E('input', { type: 'checkbox' });
153 `${response.version_number} ${response.version_code}`,
158 if (data.advanced_mode == 1) {
175 E('a', { href: sysupgrade_url }, _('Download firmware image'))
177 if (data.rebuilder) {
178 fields.push(_('Rebuilds'), E('div', { id: 'rebuilder_status' }));
181 let table = E('div', { class: 'table' });
183 for (let i = 0; i < fields.length; i += 2) {
185 E('tr', { class: 'tr' }, [
186 E('td', { class: 'td left', width: '33%' }, [fields[i]]),
187 E('td', { class: 'td left' }, [fields[i + 1]]),
197 E('label', { class: 'btn' }, [
200 _('Keep settings and retain the current configuration'),
203 E('div', { class: 'right' }, [
204 E('div', { class: 'btn', click: ui.hideModal }, _('Cancel')),
209 class: 'btn cbi-button cbi-button-positive important',
210 click: ui.createHandlerFn(this, function () {
211 this.handleInstall(sysupgrade_url, keep.checked, image.sha256);
214 _('Install firmware image')
219 ui.showModal(_('Successfully created firmware image'), modal_body);
220 if (data.rebuilder) {
221 this.handleRebuilder(content, data, firmware);
226 handle202: function (response) {
227 if ('queue_position' in response) {
228 ui.showModal(_('Queued...'), [
231 { class: 'spinning' },
232 _('Request in build queue position %s').format(
233 response.queue_position
238 ui.showModal(_('Building Firmware...'), [
241 { class: 'spinning' },
242 _('Progress: %s%% %s').format(
243 this.steps[response.imagebuilder_status][0],
244 this.steps[response.imagebuilder_status][1]
251 handleError: function (response, data, firmware, request_hash) {
252 response = response.json();
253 const request_data = {
255 request_hash: request_hash,
256 sha256_unsigned: this.sha256_unsigned,
264 { href: 'https://forum.openwrt.org/t/luci-attended-sysupgrade-support-thread/230552' },
265 _('this forum thread')
267 _('. If you don\'t find a solution there, report all of the information below.')
273 class: 'btn cbi-button cbi-button-positive important',
274 click: ui.createHandlerFn(this, function () {
275 // No translations in here as it's intended for the forum.
277 'Server response: %s'.format(response.detail)
279 + '`--version-to %s --device %s:%s`'.format(
280 request_data.version,
282 request_data.profile,
285 + '[details="Request Data"]\n'
287 + JSON.stringify({ ...request_data }, null, 4) + '\n'
291 if (response.stdout) {
293 '[details="STDOUT"]\n'
295 + response.stdout + '\n'
300 if (response.stderr) {
302 '[details="STDERR"]\n'
304 + response.stderr + '\n'
310 navigator.clipboard.writeText(text);
312 ui.showModal(_('Data copied!'), [
314 _('Paste the contents of the clipboard to '),
317 { href: 'https://forum.openwrt.org/t/luci-attended-sysupgrade-support-thread/230552' },
318 _('this forum thread')
321 E('div', { class: 'btn', click: ui.hideModal }, _('Close')),
325 _('Copy error data to clipboard')
328 E('p', {}, _('Server response: %s').format(response.detail)),
329 E('p', {}, _('Request Data:')),
330 E('pre', {}, JSON.stringify({ ...request_data }, null, 4)),
333 if (response.stdout) {
334 body.push(E('b', {}, 'STDOUT:'));
335 body.push(E('pre', {}, response.stdout));
338 if (response.stderr) {
339 body.push(E('b', {}, 'STDERR:'));
340 body.push(E('pre', {}, response.stderr));
344 E('div', { class: 'right' }, [
345 E('div', { class: 'btn', click: ui.hideModal }, _('Close')),
349 ui.showModal(_('Error building the firmware image'), body);
352 handleRequest: function (server, main, content, data, firmware) {
353 let request_url = `${server}/api/v1/build`;
355 let local_content = content;
356 const request_hash = this.request_hash.get(server);
359 * If `request_hash` is available use a GET request instead of
360 * sending the entire object.
363 request_url += `/${request_hash}`;
369 .request(request_url, { method: method, content: local_content })
370 .then((response) => {
371 switch (response.status) {
373 response = response.json();
375 this.request_hash.set(server, response.request_hash);
378 this.handle202(response);
380 let view = document.getElementById(server);
381 view.innerText = `⏳ (${
382 this.steps[response.imagebuilder_status][0]
388 poll.remove(this.pollFn);
389 this.handle200(response, content, data, firmware);
391 poll.remove(this.rebuilder_polls[server]);
392 response = response.json();
393 let view = document.getElementById(server);
394 let image = this.selectImage(response.images, data, firmware);
395 if (image.sha256_unsigned == this.sha256_unsigned) {
396 view.innerText = '✅ %s'.format(server);
398 view.innerHTML = `⚠️ ${server} (<a href="${server}/store/${
400 }/${image.name}">${_('Download')}</a>)`;
404 default: // any error or unexpected responses
406 poll.remove(this.pollFn);
407 this.handleError(response, data, firmware, request_hash);
409 poll.remove(this.rebuilder_polls[server]);
410 document.getElementById(server).innerText = '🚫 %s'.format(
419 handleRebuilder: function (content, data, firmware) {
420 this.rebuilder_polls = {};
421 for (let rebuilder of data.rebuilder) {
422 this.rebuilder_polls[rebuilder] = L.bind(
431 poll.add(this.rebuilder_polls[rebuilder], 5);
432 document.getElementById(
434 ).innerHTML += `<p id="${rebuilder}">⏳ ${rebuilder}</p>`;
439 handleInstall: function (url, keep, sha256) {
440 ui.showModal(_('Downloading...'), [
443 { class: 'spinning' },
444 _('Downloading firmware from server to browser')
451 'Content-Type': 'application/x-www-form-urlencoded',
453 responseType: 'blob',
455 .then((response) => {
456 let form_data = new FormData();
457 form_data.append('sessionid', rpc.getSessionID());
458 form_data.append('filename', '/tmp/firmware.bin');
459 form_data.append('filemode', 600);
460 form_data.append('filedata', response.blob());
462 ui.showModal(_('Uploading...'), [
465 { class: 'spinning' },
466 _('Uploading firmware from browser to device')
471 .get(`${L.env.cgi_base}/cgi-upload`, {
475 .then((response) => response.json())
476 .then((response) => {
477 if (response.sha256sum != sha256) {
478 ui.showModal(_('Wrong checksum'), [
479 E('p', _('Error during download of firmware. Please try again')),
480 E('div', { class: 'btn', click: ui.hideModal }, _('Close')),
483 ui.showModal(_('Installing...'), [
484 E('div', { class: 'spinning' }, [
485 E('p', _('Installing the sysupgrade image...')),
487 _('Once the image is written, the system will reboot.')
489 _('This should take at least a minute, so please wait for the login screen.')
491 E('b', _('While you are waiting, do not unpower device!')),
495 L.resolveDefault(callUpgradeStart(keep), {}).then((response) => {
496 // Wait 10 seconds before we try to reconnect...
497 let hosts = keep ? [] : ['192.168.1.1', 'openwrt.lan'];
498 setTimeout(() => { ui.awaitReconnect(...hosts); }, 10000);
505 handleCheck: function (data, firmware) {
506 this.request_hash.clear();
507 let { url, revision, advanced_mode, branch } = data;
508 let { version, target, profile, packages } = firmware;
511 const endpoint = version.endsWith('SNAPSHOT') ? `revision/${version}/${target}` : 'overview';
512 const request_url = `${url}/api/v1/${endpoint}`;
514 ui.showModal(_('Searching...'), [
517 { class: 'spinning' },
518 _('Searching for an available sysupgrade of %s - %s').format(
525 L.resolveDefault(request.get(request_url)).then((response) => {
527 ui.showModal(_('Error connecting to upgrade server'), [
531 _('Could not reach API at "%s". Please try again later.').format(
535 E('pre', {}, response.responseText),
536 E('div', { class: 'right' }, [
537 E('div', { class: 'btn', click: ui.hideModal }, _('Close')),
542 if (version.endsWith('SNAPSHOT')) {
543 const remote_revision = response.json().revision;
545 get_revision_count(revision) < get_revision_count(remote_revision)
547 candidates.push([version, remote_revision]);
550 const latest = response.json().latest;
552 // ensure order: newest to oldest release
553 latest.sort().reverse();
555 for (let remote_version of latest) {
556 let remote_branch = get_branch(remote_version);
558 // already latest version installed
559 if (version == remote_version) {
563 candidates.unshift([remote_version, null]);
565 // don't offer branches older than the current
566 if (branch == remote_branch) {
572 // allow to re-install running firmware in advanced mode
573 if (advanced_mode == 1) {
574 candidates.unshift([version, revision]);
577 if (candidates.length) {
583 version: candidates[0][0],
584 packages: Object.keys(packages).sort(),
588 let map = new form.JSONMap(mapdata, '');
595 'Use defaults for the safest update'
597 o = s.option(form.ListValue, 'version', 'Select firmware version');
598 for (let candidate of candidates) {
599 if (candidate[0] == version && candidate[1] == revision) {
602 _('[installed] %s').format(
604 ? `${candidate[0]} - ${candidate[1]}`
611 candidate[1] ? `${candidate[0]} - ${candidate[1]}` : candidate[0]
616 if (advanced_mode == 1) {
617 o = s.option(form.Value, 'profile', _('Board Name / Profile'));
618 o = s.option(form.DynamicList, 'packages', _('Packages'));
621 L.resolveDefault(map.render()).then((form_rendered) => {
622 ui.showModal(_('New firmware upgrade available'), [
625 _('Currently running: %s - %s').format(
631 E('div', { class: 'right' }, [
632 E('div', { class: 'btn', click: ui.hideModal }, _('Cancel')),
637 class: 'btn cbi-button cbi-button-positive important',
638 click: ui.createHandlerFn(this, function () {
639 map.save().then(() => {
640 this.applyPackageChanges({
643 version: mapdata.request.version,
644 packages: mapdata.request.packages,
645 }).then((packages) => {
649 version: mapdata.request.version,
650 profile: mapdata.request.profile
652 this.pollFn = L.bind(function () {
653 this.handleRequest(url, true, content, data, firmware);
655 poll.add(this.pollFn, 5);
659 ui.addNotification(null, E('p', error.message));
665 _('Request firmware image')
671 ui.showModal(_('No upgrade available'), [
674 _('The device runs the latest firmware version %s - %s').format(
679 E('div', { class: 'right' }, [
680 E('div', { class: 'btn', click: ui.hideModal }, _('Close')),
687 load: async function () {
688 const promises = await Promise.all([
689 L.resolveDefault(callPackagelist(), {}),
690 L.resolveDefault(callSystemBoard(), {}),
691 L.resolveDefault(fs.stat('/sys/firmware/efi'), null),
692 uci.load('attendedsysupgrade'),
695 url: uci.get_first('attendedsysupgrade', 'server', 'url').replace(/\/+$/, ''),
696 branch: get_branch(promises[1].release.version),
697 revision: promises[1].release.revision,
699 advanced_mode: uci.get_first('attendedsysupgrade', 'client', 'advanced_mode') || 0,
700 rebuilder: uci.get_first('attendedsysupgrade', 'server', 'rebuilder')
703 client: 'luci/' + promises[0].packages['luci-app-attendedsysupgrade'],
704 packages: promises[0].packages,
705 profile: promises[1].board_name,
706 target: promises[1].release.target,
707 version: promises[1].release.version,
709 filesystem: promises[1].rootfs_type,
711 // If the user has changed the rootfs partition size via owut,
712 // then make sure to keep new image the same size. A null value
713 // is interpreted by the ASU server as "default".
714 rootfs_size_mb: uci.get('attendedsysupgrade', 'owut', 'rootfs_size'),
716 return [data, firmware];
719 render: function (response) {
720 const data = response[0];
721 const firmware = response[1];
724 E('h2', _('Attended Sysupgrade')),
728 'The attended sysupgrade service allows to upgrade vanilla and custom firmware images easily.'
734 'This is done by building a new firmware on demand via an online service.'
739 _('Currently running: %s - %s').format(
747 class: 'btn cbi-button cbi-button-positive important',
748 click: ui.createHandlerFn(this, this.handleCheck, data, firmware),
750 _('Search for firmware upgrade')
754 handleSaveApply: null,